PowerPCheck documentation

 

 Version 3.0.2                                                                                                      July 1996 

©1996 Alessandro Levi Montalcini   Technical support, permissions, suggestions:
C.so Re Umberto 10                          Internet email: alm@torino.alpcom.it
10121 Torino                                   ftp://ftp.alpcom.it/software/mac/LMontalcini
Italy                                                ftp://ftp.alpcom.it/software/mac/LMontalcini/alm.html

Binary Software, Inc.                       Orders and registrations only:
2118 Wilshire Blvd Suite 900           Phone: (800) 8-BINARY (824-6279)
Santa Monica, CA 90403                   or: (310) 449-1481
United States of America                   Fax: (800) 555-7217 or (310) 449-1473
                                                        Internet email: sales@binarysoft.com
                                                        CompuServe email: 74220,3377
                                                        America Online email: BINARY SW
                                                        ftp://users.aol.com/binarysw/

• Shareware: $10
◊  This program is distributed as shareware: if you use it please honor the shareware system by sending $10 U.S. to Binary Software at the address above. You can email, fax, snail-mail, or call. When registering please specify the name and version of this program as well as your name, mailing address, email address, phone number, fax number, and your credit card number and expiration date (we accept Visa, MasterCard, American Express, and Discover). You can also pay with a check, money order, or cash.
◊  Binary Software is only collecting the registrations on my behalf; please contact me directly by email for any information, suggestion, permission, or request about this software. If you want to send non-U.S. cash or any other material including software, books, magazines, CD-ROMs or any hardware, please send it to me at my Italian address. If you do so, however, you should also notify me by email because I only receive my snail mail once per month.
◊  If you can’t afford to register you may still want to send Binary Software your name, address and email address so they can send you new product announcements and other special offers.
◊  Site licenses and group discounts are available for 5 or more registrations. Please check my ftp site or send email for more information.
◊  Please register: your support is the only way for me to keep working on cool shareware programs.

• Introduction
◊  PowerPCheck is a cool drag & drop utility that looks for native PowerPC code inside applications, control panels, extensions and all other executable files. It can check individual files as well as folders or entire disks; it inspects both the data fork and the resource fork of each file and creates a detailed text report of all the native code it finds. Version 3.0 can also remove the PowerPC or 68K code from the inspected files.

• Removing code
◊  PowerPCheck can remove unused code from the files it inspects. This operation is potentially dangerous because some programs may stop working or even crash if you remove some code that they expect to find in their own files.
◊  The PowerPC application code stored in the data fork can usually be removed without disturbing the 68K application; the stripped application should still run on both PowerPC and 68K Macs, although it will be a lot slower when running on a Power Mac. This is not guaranteed to work, but it’s the safest removal you can choose.
◊  The PowerPC code stored in resource forks is a lot more dangerous to remove, since it’s usually directly accessed by the related application. The stripped program will most likely run on a 68K Mac, but it may easily crash or stop working if you move it to a Power Mac.
◊  Removing the 68K code from the resource fork of an application always prevents it from running on a 68K Macintosh. The application should still be able to run on a Power Mac, but you’ll get an error message from the Finder if you try to launch it on a 68K machine. Note that this kind of removal can only be done on applications that carry native PowerPC code in their data forks.
◊  Before attempting to remove any kind of code, please make sure you have a backup copy of all your applications, plug-ins, extensions, control panels and shared libraries. Code removal can help if you have a 68K Mac and a small hard disk filled with megabytes of unused PowerPC code, but stripped-down programs can’t be restored to their original state if you don’t have a clean backup copy somewhere on your shelves.

• Technical information
◊  There are two kinds of resources that contain native PowerPC code: pure code resources only contain what is called a code fragment, while accelerated and fat resources have a routine descriptor as well. This has nothing to do with performance and doesn’t affect end users, but programmers may be interested in this topic; PowerPCheck marks with an asterisk all code resources that have a routine descriptor.
◊  PowerPCheck uses a simple method to speed up file scanning: the 'TYP#' 128 resource contains a list of file types to skip, and the 'TYP#' 129 resource contains a list of resource types to skip. You may add (or remove) file and resource types with ResEdit if you know what you’re doing. Note that PowerPCheck also skips all files that have an empty resource fork.

• Distribution
◊  This software is ©1995-96 Alessandro Levi Montalcini. It can be freely distributed as long as it is not modified and there’s no charge for it, but it may not be included in any commercial package without my consent.
◊  All online services and bulletin boards may make it available to their users at no charge other than the normal connection fees.
◊  All non-profit user groups may distribute it at no charge.
◊  All magazines may publish it on floppy disk or CD-ROM without asking me first, as long as I get a copy of the issue containing my software.
◊  All CD-ROM shareware collections and CD-ROM magazines may include it without my prior consent, as long as I get either a copy of the CD-ROM or an offer to buy the CD-ROM at a discounted price.
◊  All redistribution companies such as Pacific HiTech, AMUG, Celestin or Educorp may distribute it, as long as I get a copy of each media containing my software and a catalog of the company’s offerings (where applicable).
◊  You may find the latest version of all my shareware and freeware programs by anonymous ftp to ftp.alpcom.it, inside the /software/mac/LMontalcini directory. The ALM Share and ALM Free packages, which contain most of my stuff and can be registered at a very low price, are also available there.

• Version history
◊  3.0.2 - Fixed a bug that could cause the “Don’t Save” button to be automatically pressed.
◊  3.0.1 - Recompiled with CodeWarrior 7.
◊  3.0 - PowerPCheck can now remove the PowerPC or 68K code from the inspected files.
◊  2.1 - This version is faster, requires less memory and can work in the background. Fixed various interface and file-saving issues.
◊  2.0 - First shareware release; rewritten from scratch, now scans folders and disks and inspects resources.
◊  1.2.1 - Cleaned up the code and updated documentation.
◊  1.2 - Fat version! Runs native on Power Macs.
◊  1.1 - Rebuilt with new versions of the compiler (never released).
◊  1.0 - First public release.

• Disclaimer
◊  This software should never cause any damage, but you’re using it at your own risk. As an independent software developer, I can make no warranties whatsoever on it.

• Have fun!
◊  And don’t forget to register your shareware, so that more cool inexpensive utilities can see the light in the future.